Inside Macintosh: QuickTime Components /

Chapter 9 - Movie Data Exchange Components / Movie Data Exchange Components Reference

Configuring Movie Data Export Components /

MovieExportGetAuxiliaryData

The MovieExportGetAuxiliaryData function allows an application to retrieve additional data from your component. This additional data may be created during the data export process.

pascal ComponentResult MovieExportGetAuxiliaryData
                                        (ComponentInstance ci,
                                          Handle dataH, 
                                          OSType *handleType);

ci

Identifies the application's connection to your movie data export component.

data

Contains a handle that is to be filled with the additional data. Your component should resize this handle as appropriate. Your component is not responsible for disposing of this handle.

handleType

Contains a pointer to the type of data you place in the handle specified by the data parameter.

DESCRIPTION

The MovieExportGetAuxiliaryData function allows an application to retrieve additional data that is generated during the data export process. The application may then use the data as appropriate. Your component may create this data in cases where the target data type cannot accommodate all of the converted data. For example, if your component exports data into 'TEXT' handles or files, you might choose to preserve associated style information for that text. However, 'TEXT' resources cannot store that style information. You could save that style information in a 'styl' handle and allow an application to retrieve it after the conversion.

Your component should expect the application to call this function after the export process ends.

RESULT CODE

badComponentSelector

0x80008002

Function not supported

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help